Cloud Tracing 
Spring Cloud Sleuth 


Spring Cloud Sleuth introduces unique IDs to your logging which are consistent between 
microservice calls which makes it possible to find how a single request travels from one 
microservice to the next. Spring Cloud Sleuth adds two types of IDs to your logging, one called a 
Trace ID and the other called a Span ID. The span ID represents a basic unit of work, for 
example sending an HTTP request. The trace ID contains a set of span IDs, forming a tree-like 
structure. The Trace ID will remain the same as one microservice calls the next. 









traceld: 1337 


getCustomerWithAddress|  spanld: 1337 


Downstream Service 


getCustomer getAddress 
traceld: 1337 traceld: 1337 
spanlid: 4711 spanid: 0815 





Upstream Service. Upstream Service. 

















Demonstration of Span ID and Trace ID 


The following libraries helps for distributed tracing in cloud: 
Sleuth 


Sleuth is used for enhancing logs in any application, but especially in a system built up of 
multiple services. Required dependency is spring-cloud-sleuth. It provides basic info of a 
HTTP request with Span Id and Trace Id. 


1. Add Sleuth Dependency to your pom xml 
2. Use any logger like log4j for logging the request. 


The following Sleuth and Zipkin dependencies are used for distributed tracing in cloud: 


Name on Initializr artifactid 


Sleuth spring-cloud-starter-sleuth 
Sleuth Stream spring-cloud-sleuth-stream 
Zipkin Client spring-cloud-starter-zipkin 
Zipkin Stream spring-cloud-sleuth-zipkin-stream 
Zipkin Ul ‘spring-boot-starter 
Zipkin-autoconfigure-ui 
Zipkin Server spring-boot-starter 
zipkin-server 


Sleuth 


Sleuth is used for enhancing logs in any application, but especially in a system built up of 
multiple services. Required dependency is spring-cloud-starter-sleuth. It provides basic info of 
a HTTP request with Span Id and Trace Id. 


1. Add Sleuth Dependency to your pom.xml 
2. Use any logger like log4j for logging the request. 


Name on Initializr_|artifactid HTTP| AMQP 
Sleuth spring-cloud-starter-sleuth 


Adds trace and span ids to the logs 





Zipkin 
Zipkin provides the following libraries: 
1. Zipkin UI 


Zipkin UI provides visualization of spans provided by Zipkin Service. Add zipkin- 
autoconfigure-ui dependency. 


2. Zipkin Client 


Zipkin Client requires spring-cloud-sleuth-zipkin dependency. This should be added in 
application which will be traced by Zipkin Server. 


3. Zipkin Server 


Zipkin Server is a Spring Boot application. It's used for capturing timing data, it also has 
a centralized repository, and a microweb server that allows you to display, and search 
through spans and traces of your distributed programs. By default, the server listens on 
port 9411. Use @EnableZipkinServer in Zipkin Application. Add zipkin-server 
dependency. Zipkin Server provides information about your span. Zipkin Server is used 
for handling HTTP (Hypertext Transfer Protocol). Zipkin Server allows us to persist data 
in external database like MySQL and Cassandra. 


4. Zipkin Stream 

There is another way for publishing messages to the Zipkin server over a 
Spring Cloud Stream binder like RabbitMQ or Apache Kafka. Zipkin Stream is used to 
adapt incoming Spring Cloud Stream-based Sleuth Spans into Zipkin's Spans and then 
persist them using Spanstore like MySQL and Cassandra. Zipkin Stream Server is used for 
handling АМОР (Advanced Message Queuing Protocol). Use 
@EnableZipkinStreamServer in Zipkin Application. Add spring-cloud-sleuth-zipkin- 
stream dependency. 


To Conclude, Zipkin Server listens to Zipkin Client for collectiong Spans 
and it helps to visualize those collected information by Zipkin UI. Zipkin Stream Server is 
used for receiving messages from Spring Cloud Stream using any Spring Cloud Stream 
binder. We can also configure spring.sleuth.sampler.percentage between 0.1 and 1.0 
which helps us to trace only particular request using custom sampler bean. Ex. trace only 
requests that have 500 as status code. 


MySQL with Zipkin 


1. Configure your application.yml 





(RABBIT. HOST-localhost) 
application: 
name: zipkin-stream-server 
datasource: 
schema: classpath:/mysql.sql 
url: jdbe:mysql://localhost:3306/{your_db_name} 
username: root 
password: root 
driver-class-name: com mysql jdbc Driver 
initialize: true 
continue-on-error: true 
sleuth: 
enabled: false 
zipkin: 
storage: 


type: mysql 


2. Add the following dependencies to your pom.xml 


<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 

</dependency> 

<dependency> 
«groupId»org. springframework.boot«/groupId» 
<artifactId>spring-boot-starter-jdbc</artifactId> 

</dependency> 

<dependency> 
«groupId»io.zipkin.javac/groupId» 
<artifactId>zipkin-autoconfigure-storage-mysql</artifactId> 

</dependency> 





3. Note 


If you are facing any issues while connecting MySQL set useSSL property as no in 
datasource url. Set autoReconnect property as true if required. If you are facing any 
exceptions from sleuth, configure sleuth-enabled property. To know more visit - 
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To use RabbitMQ as a middle buffer: 
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Sleuth Stream Zipkin UI 
(spring-cloud-sleuth-stream) (zipkin-autoconfigure-ui) 
Zipkin Stream 
spring-cloud-stream-binder-rabbit (spring-cloud-sleuth-zipkin-stream) 


spring-cloud-stream-binder-rabbit 


Zipkin Stream Usage 
АМОР АМОР | Zipkin UI Server 
[em] ae seabed 
Exchange: Queue: 


sleuth sleuth.sleuth 


AMOQP Usage 
Мате on Initializr_|artifactid НТТР | АМОР 
Sleuth spring-cloud-starter-sleuth 
Sleuth Stream spring-cloud-sleuth-stream Producer 
Zipkin Client spring-cloud-starter-zipkin Client 
Zipkin Stream spring-cloud-sleuth-zipkin-stream Consumer 
Zipkin UI spring-boot-starter Server Consumer 
Zipkin-autoconfigure-ui 
Zipkin Server spring-boot-starter Server 
zipkin-server 
‘Stream Rabbit Spring-cloud-starter-stream-rabbit Both 


Usage of Sleuth and Zipkin Dependencies in terms of HTTP and AMQP 
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Sleuth in Server Side 


Zipkin 


Zipkin provides the following libraries: 


Ё 


Zipkin UI 


Zipkin UI provides visualization of spans provided by Zipkin Service. Add zipkin-server 
and zipkin-autoconfigure-ui dependencies. Use @EnableZipkinServer in Zipkin 
Application. 


Zipkin Client 


Zipkin Client requires spring-cloud-sleuth-zipkin dependency. This should be added in 
application which will be traced by Zipkin Server. spring-cloud-starter-zipkin 
dependency will also work. 


Zipkin Stream 


Zipkin Stream provides detailed information about your span. Zipkin Stream is highly 
useful when depth is high like 4-5. It provides information like HTTP host. path. method. 
The methods called by the request, Trace Id and Span Id are provided. Add spring- 
cloud-sleuth-zipkin-stream dependency. It allows us to know more information when 
four or above requests are linked and dependent. Use @EnableZipkinStreamServer in 
Zipkin Application. We can configure spring.sleuth.sampler.percentage between 0.1 
and 1.0 which helps us to trace only particular request using custom sampler bean. Ex. 
trace only requests that have 500 as status code. 
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Span Information in Zipkin Server 


Zipkin Stream Server 
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Find Traces 


Sleuth Stream 


Spring Cloud Sleuth Stream is deprecated. 


For more info - https://cloud.spring.io/spring-cloud-sleuth/single'spring-cloud-sleuth.html 


Dependencies 
LSleuth 

<dependency> 

<groupld>org. springframework.cloud</groupld> 
<artifactld>spring-cloud-starter-sleuth</artifactld> 


</dependency> 


2. Zipkin Server 
‘dependency> 

<groupld>io.zipkin java</grouplé> 

<artifactld>zipkin-server</artifactld> 


Jdependency> 


3. Zipkin UI 
<dependency> 

<groupld>io.zipkin java-/groupld-- 
<artifactId>zipkin-autoconfigure-ui</astifactld> 
<scope>runtime</scope> 

</dependency> 


4. Zipkin Stream Server 
<dependency> 

"*groupld-org.springframework cloud-/groupld- 
<artifactld>spring-cloud-sleuth-zipkin-stream~/artifactld> 
</dependency> 


5. Zipkin Client 
“<dependency> 

<groupld>io.zipkin java-/groupld-- 
<artifactld>spring-cloud-sleuth-zipkin~/artifactld> 


‘<version>0.4.3</version> 








https:// of Ls 
http;//rvanibaxter.com/cloud/spring*6?0cloud/spring/2016/07/07/spring-cloud-sleuth html 
z//dzone.conyarticles/di: L-tracing-with-spring-cloud-sleuth-and-s 


http://www _baeldung. com/spring-cloud-sleuth-single-application 





(уугуу ibm. com/blogs/bluemix/2017/09/distributed-tracins lication-using- 
spring-sleuth/ 
https://cloud. spring io/spring-cloud-sleuth/single/spring-cloud-sleuth html 








